Working with Unified Projects
The section Working with Helix QAC Dashboard describes how project definitions can be shared amongst other users by storing them on Helix QAC Dashboard as Unified projects. This can all be done through command line options.
To convert your local project into a Unified project, use the ‑‑convert‑to‑unify
command, which uploads the project definition to Helix QAC Dashboard. This is equivalent to using the Create Unified Project dialog.
qacli admin -P <directory> --convert-to-unify --project-name <unifyname>
--server-vcs <file> --use-local-vcf --repository-path <path > --url
<[protocol://]host[:port]> --token <tkn>
The arguments to the above command are as follows:
- P (or --qaf-project) gives the location of the Helix QAC project.
- project-name is the name given to the project in Helix QAC Dashboard. Once the project has been uploaded, the local Helix QAC project will be adjusted to use this name.
- server-vcs gives the name of the version control system file to be used. The list of files can be found by running the command:
- use-local-vcf specifies that a local copy of the Version Control Compatibility File should be used where available. If use-local-vcf is not specified, then the file associated with the server-vcs option will be downloaded and used as the VCF.
- repository-path contains any additional information needed by the version control system holding the source code. This is an optional parameter.
- url is the address of the Helix QAC Dashboard server.
- token is the string value returned from the get-token function.
Alternatively, the ‑‑username
and ‑‑password
(or ‑‑password‑file
) parameters can be used.
Once the project has been uploaded to Helix QAC Dashboard, it is available for other users to download. Users can see which Unified projects are available for download by using the following command:
The actual download is performed by using the following command:
qacli admin -P <directory> --pull-unify-project --project-name<unifyname> --url <[protocol://]host[:port]> --token <tkn>
If the definition of the Unified project needs to be updated, the new definition can be uploaded to Helix QAC Dashboard using the following command: